home *** CD-ROM | disk | FTP | other *** search
/ IRIX 6.2 Development Libraries / SGI IRIX 6.2 Development Libraries.iso / dist / complib.idb / usr / share / catman / p_man / cat3 / complib / dgttrs.z / dgttrs
Text File  |  1996-03-14  |  3KB  |  133 lines
  1.  
  2.  
  3.  
  4. DDDDGGGGTTTTTTTTRRRRSSSS((((3333FFFF))))                                                          DDDDGGGGTTTTTTTTRRRRSSSS((((3333FFFF))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      DGTTRS - solve one of the systems of equations  A*X = B or A'*X = B,
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      SUBROUTINE DGTTRS( TRANS, N, NRHS, DL, D, DU, DU2, IPIV, B, LDB, INFO )
  13.  
  14.          CHARACTER      TRANS
  15.  
  16.          INTEGER        INFO, LDB, N, NRHS
  17.  
  18.          INTEGER        IPIV( * )
  19.  
  20.          DOUBLE         PRECISION B( LDB, * ), D( * ), DL( * ), DU( * ), DU2(
  21.                         * )
  22.  
  23. PPPPUUUURRRRPPPPOOOOSSSSEEEE
  24.      DGTTRS solves one of the systems of equations
  25.         A*X = B  or  A'*X = B, with a tridiagonal matrix A using the LU
  26.      factorization computed by DGTTRF.
  27.  
  28.  
  29. AAAARRRRGGGGUUUUMMMMEEEENNNNTTTTSSSS
  30.      TRANS   (input) CHARACTER
  31.              Specifies the form of the system of equations:
  32.              = 'N':  A * X = B  (No transpose)
  33.              = 'T':  A'* X = B  (Transpose)
  34.              = 'C':  A'* X = B  (Conjugate transpose = Transpose)
  35.  
  36.      N       (input) INTEGER
  37.              The order of the matrix A.  N >= 0.
  38.  
  39.      NRHS    (input) INTEGER
  40.              The number of right hand sides, i.e., the number of columns of
  41.              the matrix B.  NRHS >= 0.
  42.  
  43.      DL      (input) DOUBLE PRECISION array, dimension (N-1)
  44.              The (n-1) multipliers that define the matrix L from the LU
  45.              factorization of A.
  46.  
  47.      D       (input) DOUBLE PRECISION array, dimension (N)
  48.              The n diagonal elements of the upper triangular matrix U from the
  49.              LU factorization of A.
  50.  
  51.      DU      (input) DOUBLE PRECISION array, dimension (N-1)
  52.              The (n-1) elements of the first superdiagonal of U.
  53.  
  54.      DU2     (input) DOUBLE PRECISION array, dimension (N-2)
  55.              The (n-2) elements of the second superdiagonal of U.
  56.  
  57.      IPIV    (input) INTEGER array, dimension (N)
  58.              The pivot indices; for 1 <= i <= n, row i of the matrix was
  59.              interchanged with row IPIV(i).  IPIV(i) will always be either i
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. DDDDGGGGTTTTTTTTRRRRSSSS((((3333FFFF))))                                                          DDDDGGGGTTTTTTTTRRRRSSSS((((3333FFFF))))
  71.  
  72.  
  73.  
  74.              or i+1; IPIV(i) = i indicates a row interchange was not required.
  75.  
  76.      B       (input/output) DOUBLE PRECISION array, dimension (LDB,NRHS)
  77.              On entry, the right hand side matrix B.  On exit, B is
  78.              overwritten by the solution matrix X.
  79.  
  80.      LDB     (input) INTEGER
  81.              The leading dimension of the array B.  LDB >= max(1,N).
  82.  
  83.      INFO    (output) INTEGER
  84.              = 0:  successful exit
  85.              < 0:  if INFO = -i, the i-th argument had an illegal value
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.